查询 Balance Settlement 对象列表

返回之前创建过 balance_settlement 对象的一个列表。列表是按创建时间进行排序,总是将最新的 balance_settlement 对象显示在最前。

请求参数描述
APP_ID required string对应 app 对象的 id,该参数仅需要填写在请求地址内,查看 如何获取App ID
user optional string余额结算 user 对象的 id
status optional string结算状态。待结算:created(表示余额还未到结算用户余额账户),已入账:credited(表示余额已到账但不可用),已结算:succeeded(表示余额到账且可用)。
refunded optional boolean余额结算金额是否有退款。
charge optional string结算关联的 charge 对象的 id
order_no optional string结算关联的 charge 对象的 order_no
page optional int页码,默认值为 "1",取值范围:1~100000000。
per_page optional int每页数量,默认值为 "10"。
created[gt] optional timestamp创建时间大于该值,用 Unix 时间戳表示。
created[gte] optional timestamp创建时间大于或等于该值,用 Unix 时间戳表示。
created[lt] optional timestamp创建时间小于该值,用 Unix 时间戳表示。
created[lte] optional timestamp创建时间小于或等于该值,用 Unix 时间戳表示。

返回

返回一个 balance_settlement 对象列表,或者一个错误,详见 错误

定义

GET https://api.pingxx.com/v1/apps/{APP_ID}/balance_settlements
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/balance_settlements \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1517312911" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
"object": "list",
  "url": "/v1/apps/app_1Gqj58ynP0mHeX1q/balance_settlements",
  "has_more": true,
  "data": [
    {
      "id": "670180130750711562240000",
      "object": "balance_settlement",
      "app": "app_1Gqj58ynP0mHeX1q",
      "created": 1517314911,
      "livemode": false,
      "amount": 100,
      "status": "succeeded",
      "user": "user_001",
      "user_fee": 5,
      "charge": "ch_aX9aH8Wf1anHnjbrvTOuv5SK",
      "order_no": "20181517314882",
      "time_credited": 1517314911,
      "time_succeeded": 1517314911,
      "refunded": false,
      "amount_refunded": 0,
      "transaction_no": "20180130054018297440163168",
      "failure_msg": null
    },
    {...},
    {...}
  ]
}